#第 8 章：单 Gateway 多 Agent 配置与管理

# 查看已注册的 Agent 列表
openclaw agents list

# 1. 创建 Agent workspace 目录
mkdir -p ~/.openclaw/agents/agent-2/workspace
cd ~/.openclaw/agents/agent-2/workspace

# 2. 创建身份文件
cat > IDENTITY.md << 'EOF'
---
name: 运营助手
role: 运营数据分析与报告生成
style: 专业严谨，数据驱动
---
# 运营助手

我是一个专注于运营数据分析的 AI 助手。

## 核心能力
- 数据报表自动生成
- 竞品监控与分析
- 用户反馈整理
EOF

# 3. 创建行为准则
cat > SOUL.md << 'EOF'

## 行为准则
- 以数据说话，避免主观判断
- 报告格式清晰、结构化
- 敏感数据脱敏处理
EOF

# 4. 创建记忆和技能目录
mkdir -p memory/ skills/ config/

# 5. 验证 workspace 结构
tree ~/.openclaw/agents/agent-2/workspace/

# 检查路由配置是否正确
openclaw config validate

# 查看当前生效的路由映射
openclaw agents routes

# 发送信号触发重载
openclaw gateway reload

# 或通过 API
curl -X POST http://localhost:18789/admin/reload

# 验证重载结果
openclaw agents list --verbose

# 创建共享记忆区
mkdir -p ~/.openclaw/workspace/shared-memory

# 初始化共享状态文件
cat > ~/.openclaw/workspace/shared-memory/project-status.json << 'EOF'
{
  "lastUpdated": "2026-03-06",
  "activeProjects": [],
  "sharedNotes": []
}
EOF

# Step 1: Agent 1 (技术助手) 将技术报告写入共享目录
echo "## 技术周报 - $(date +%Y-%m-%d)
- 完成功能 A 开发
- 修复 Bug #123
- 性能优化提升 20%" > ~/.openclaw/workspace/shared-memory/tech-report.md

# Step 2: Agent 2 (运营助手) 的 Cron 任务定期检查并生成分析
# 在 Agent 2 的 cron/jobs.json 中配置：
cat > ~/.openclaw/agents/agent-2/cron-check.json << 'EOF'
{
  "jobs": [
    {
      "name": "analyze-tech-report",
      "schedule": "0 9 * * 1",
      "command": "分析共享目录中的技术报告并生成运营洞察"
    }
  ]
}
EOF

# Step 3: 查看协作状态
cat ~/.openclaw/workspace/shared-memory/project-status.json

# 查看所有 Agent 状态
openclaw agents list

# 查看单个 Agent 详情（包含运行状态、活跃会话数等）
openclaw agents status agent-1

# 查看资源占用统计
openclaw agents stats

# 查看 Gateway 整体健康状态
openclaw gateway status

# 实时监控 Agent 日志输出
openclaw logs --agent agent-1 --follow

# Step 1: 创建技术助手 Agent
mkdir -p ~/.openclaw/agents/tech-agent/workspace/{memory,skills,config}
cat > ~/.openclaw/agents/tech-agent/workspace/IDENTITY.md << 'EOF'
---
name: 技术助手
role: 代码审查与技术咨询
style: 严谨、逻辑清晰
---
# 技术助手
专注于代码质量和技术架构。
EOF

# Step 2: 创建运营助手 Agent
mkdir -p ~/.openclaw/agents/ops-agent/workspace/{memory,skills,config}
cat > ~/.openclaw/agents/ops-agent/workspace/IDENTITY.md << 'EOF'
---
name: 运营助手
role: 运营数据分析
style: 数据驱动、简洁明了
---
# 运营助手
专注于数据分析与运营洞察。
EOF

# Step 3: 验证目录结构
echo "=== 技术助手 ===" && ls ~/.openclaw/agents/tech-agent/workspace/
echo "=== 运营助手 ===" && ls ~/.openclaw/agents/ops-agent/workspace/

# Step 4: 注册到 Gateway
openclaw agents list

# Step 1: 编辑路由配置（手动编辑 openclaw.json 或使用命令）
# 在 openclaw.json 中添加 agents 和 routing 配置

# Step 2: 验证配置有效性
openclaw config validate

# Step 3: 重载 Gateway 使配置生效
openclaw gateway reload

# Step 4: 查看路由映射
openclaw agents routes

# Step 5: 通过 API 测试消息分发
curl -s http://localhost:18789/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "技术问题：如何优化数据库查询？"}' | jq .agentId

curl -s http://localhost:18789/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "运营报告：本周用户增长趋势"}' | jq .agentId

# Step 1: 创建共享目录
mkdir -p ~/.openclaw/workspace/shared-memory/reports

# Step 2: 模拟技术助手输出报告
cat > ~/.openclaw/workspace/shared-memory/reports/weekly-tech.md << 'EOF'
# 技术周报 2026-03-06

## 完成事项
- API 接口重构完成，响应时间减少 40%
- 新增 3 个自动化测试用例

## 待处理
- 数据库迁移计划制定
EOF

# Step 3: 配置运营助手的定时检查任务
cat > ~/.openclaw/agents/ops-agent/workspace/config/watch-reports.json << 'EOF'
{
  "watch": {
    "path": "~/.openclaw/workspace/shared-memory/reports/",
    "pattern": "*.md",
    "action": "分析技术报告，提取关键指标，生成运营摘要"
  }
}
EOF

# Step 4: 验证共享文件可被两个 Agent 读取
cat ~/.openclaw/workspace/shared-memory/reports/weekly-tech.md

# Step 5: 查看协作状态
openclaw agents stats

# 确认每个 Agent 的 workspace 路径独立
openclaw agents list --verbose